SAFE Beaker Browser: Installation Walkthrough

Linux/Ubuntu Install Instructions:

Step 01: Install Git Introduction | Ubuntu
Step 02: Sign up for https://github.com/
Step 03: Set up Git - GitHub Docs
Step 04: Generating a new SSH key and adding it to the ssh-agent - GitHub Docs
Step 05: Adding a new SSH key to your GitHub account - GitHub Docs

Step 06: Install node js
Use option one make sure to install the latest version

Check to see what the latest version is here Download | Node.js

Step 07: Open Terminal

git clone https://github.com/joshuef/beaker.git cd beaker
git checkout SafePOC npm install
npm run rebuild npm start

Step 08: Any time you want to run the browser again all you have to do is open terminal

cd beaker npm start

Note 01: If you want to do a fresh install. Delete the beaker folder and start at Step 07:
Note 02: Do not worry about any errors that appear.

15 Likes

this was easy ! Thanks for the instructions

6 Likes

Thanks, it took me a while to figure out. I figured once I could do it, I should write it down.

1 Like

If you haven’t tried the SAFE Browser, what are you waiting for :wink:

3 Likes

What about for windows?

1 Like

I’ll do my best, but cross your fingers.

3 Likes

It doesn’t work on Windows, because the npm package for go-ipfs doesn’t work on Windows (See here). Therefore, “npm install” will fail because it can’t get that dependency.

I tried compiling go-ipfs manually following these instructions.

I successfully compiled it, but npm doesn’t seem to know that it exists. And now I’m stuck, because I know next to nothing about how NodeJS and npm actually works. Maybe there’s a method to manually get npm to install go-ipfs from the compiled version? I don’t know.

Any ideas, @betterthantrav?

If you successfully compiled the browser, what’s the problem?

You know about as much as I do. @joshuef can you help us?

No, not the browser.

I probably should have explained in the beginning of my post that my first steps were to just follow the instructions for Linux and see what happens.

So I cloned the Github repo, changed the branch, and ran npm install

Of course, it didn’t work. So I looked through the output, and it looks like the errors were caused by one dependency that npm couldn’t install: go-ipfs-dep

It’s just a package that the browser needs to compile, because beaker uses IPFS too. Since that package couldn’t be installed via npm, I just compiled that individual go-ipfs package by itself, which is where I got stuck because I wasn’t sure how to make npm use my compiled version to fulfill the dependency (or if such a thing is even possible… Like I said, I don’t much about how npm works and what it can do)

Edit: Here’s my output from running npm install in the beaker directory. I snipped out what looked like irrelevant output, and hid my log-in name…

Ah, you got it going! Brilliant.

Thanks @betterthantrav my node and npm were indeed out of date now. Paul’s beaker works now but I get a problem with sqlite3 for the SafePOC

When I run install, I get a lot of these warning:

And then when I start I get:

Any idea?

1 Like

I think @whiteoutmashups had a similar problem to this.

@DavidMtl that looks to me like the npm run rebuild step is missing in beaker.

2 Likes

Worked, I believe my mistake was to use “npm rebuild” instead of “npm run rebuild”.

4 Likes

Thanks mate! Great directions, installed perfect first try on newest Mint Distro.

Wow this thing moves fast…oh boy I feel some more long nights coming on. The creative juices are flowing for sure!

It is running the js/css perfect. I would say even better than firefox or chrome.

I can’t help it. Here is another page I don’t have linked yet in the menu:

6 Likes

I’ve also tried it today and think it’s really smooth… Done some regular websurfing and it’s very responsive etc … Like it !

2 Likes

@joshuef I am trying to crack the windows installation and I keep getting this error…

2 Likes

exactly what I got stuck with on windows…

can’t wait until I’m back home to my ubuntop :slight_smile:

EDIT: Just tried again now and got that exact same error popup again…

1 Like

Looks like the same error @DavidMtl had above.

npm run rebuild works without errors on windows?

@joshuef this is what I have done so far, but it gives me the above bellow error.

Windows Install Instructions:

Step 01: Sign up for https://github.com/
Step 02: Install Git Git - Downloading Package
Step 03: Open Git Bash C:\Program Files\Git\git-bash.exe
Step 04: Set up Git - GitHub Docs
Step 05: Generating a new SSH key and adding it to the ssh-agent - GitHub Docs
Step 06: Adding a new SSH key to your GitHub account - GitHub Docs

Step 07: Open Git Bash !!!You must close Git Bash!!!

Step 08: Install the latest version of node js

!!!Do not instal the LTS verison!!!

Step 09: Install Mercurial X.X MSI installer Mercurial SCM

Step 10: Install Go
10a: Downloads - The Go Programming Language
10b: Easy Go Programming Setup for Windows - Wade Wegner

Step 11: Install latest version of Java https://java.com/en/download/

Step 12: Open Git Bash C:\Program Files\Git\git-bash.exe

mkdir c:/browser cd c:/browser
git clone https://github.com/joshuef/beaker.git cd beaker
git checkout SafePOC npm install
npm run rebuild npm start

1 Like