How to install Knowfox at Uberspace

Olav Schettler edited this page Jun 1, 2017 · 6 revisions

Uberspace is a high quality German Hosting Service Provider. They are special in that they provide very competitive features of a fully managed web hosting package for a very good price. In particular, you get 10GB space for your data and media. Also, they do provide full SSH access which is required for installing Knowfox.

Here we go ...

First, register yourself an account. Uberspace offers a full trial month. You don't need to provide payment credential to get started. So, go to and register by clicking on


Then, you have to choose a username


... and fill in some minimal personal data:


Finally, click on Make it so.


With that, your Uberspace is already reachable on the web. Mine is at

On the Uberspace Dashboard, you now have to configure your SSH access. This can either be password-based or, as I have chosen to do, using an SSH key.

But, before you can enable passwordless access, you need to create yourself an SSH key on your local machine. On a Mac, open a Terminal and type the command

ssh-keygen -f ~/.ssh/uberspace

Choose an empty passkey by pressing ENTER twice.

Next, add the following paragraph at the end of your file ~/.ssh/config:

Host uberspace
  User olav
  IdentityFile ~/.ssh/uberspace

Change the hostname and username to the settings from your Uberhost DATENBLATT.

Now you can proceed to install Knowfox on your shiny new Uberhost. Here are the steps:

ssh uberspace

php installer

tar xzf v0.2.2.tar.gz

# Change "olav" to your account name
mv knowfox-0.2.2/* /var/www/virtual/olav
cd /var/www/virtual/olav

rm -rf html
mv public html

~/composer.phar install

cp ~/knowfox-0.2.2/.env.example .env

cat ~/.my.cnf

take note of 2nd password

Edit the file ".env" with the command nano .env and change the following values (Change "olav" to your account name)


Next, you need to set up a mailer to be able to register yourself a user. The easiest is to use a free account with Create yourself a free account there and enter the username and password:


From this, change the following two variables in .env


If you want to use the bookmarklet, there is one other thing to include into your .env file. To extract the text and some metadata from bookmarked pages, Knowfox uses a free service from Postlight. Please create yourself an account there and include their key into your .env file:


Save and exit the editor. Next you need to create an application key and set up the database:

php artisan key:generate
php artisan migrate

One more step is needed to build and install the frontend stuff:

  • npm install

With that, you can open Knowfox in your browser at This is what it looks like:


Click on Register and create yourself a user:


After registration, you are redirected to the list of concepts:


To start journaling, you first need to create a Journal root:


At this point, you have a few options:

  • Start a journal by clicking on the current date.
  • Create a new concept
  • Install the bookmarklet into your browser's bookmark bar and start collecting bookmarks.

Here is what a journal entry looks like:


This concludes the second variant of how to get started with Knowfox.

Know more and have fun,

-- Olav

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.