SAFE Beaker Browser: Installation Walkthrough


#1

Linux/Ubuntu Install Instructions:

Step 01: Install Git https://help.ubuntu.com/lts/serverguide/git.html
Step 02: Sign up for https://github.com/
Step 03: https://help.github.com/articles/set-up-git/#platform-linux
Step 04: https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/#platform-linux
Step 05: https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/#platform-linux

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


Check to see what the latest version is here https://nodejs.org/en/download/

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.


Requested Feature Please For Site Forms
SAFEr Browser(s) Proposal
#2

this was easy ! Thanks for the instructions


#3

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


#4

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


#5

What about for windows?


#6

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


#7

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?


#8

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


#9

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


#10

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…


#11

Ah, you got it going! Brilliant.


#12

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?


#13

I think @whiteoutmashups had a similar problem to this.

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


#14

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


#15

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:


#16

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


#17

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


#18

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…


#19

Looks like the same error @DavidMtl had above.

npm run rebuild works without errors on windows?


#20

@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 https://git-scm.com/download/win
Step 03: Open Git Bash C:\Program Files\Git\git-bash.exe
Step 04: https://help.github.com/articles/set-up-git/#platform-windows
Step 05: https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/#platform-windows
Step 06: https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/#platform-windows

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

Step 08: Install the latest version of node js
https://nodejs.org/en/download/current/
!!!Do not instal the LTS verison!!!

Step 09: Install Mercurial X.X MSI installer https://www.mercurial-scm.org/downloads

Step 10: Install Go
10a: https://golang.org/dl/
10b: http://www.wadewegner.com/2014/12/easy-go-programming-setup-for-windows/

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