Translation(s): English -

This page describes the installation, configuration and first usage of scuttle. It is quite straight forwards, barely worth to mention at all (the most mini version to describe it: install apache2, install mysql, install scuttle, link /usr/share/scuttle to /var/www/content, open it in a web-browser and create a user. If you like rename register.php to avoid spammers).


Description: Web-based social bookmarking system

  • Allows multiple users to store, share and tag their favourite links online.
    • Scuttle supports most of the API.
      • Almost all of the neat tools made for that system can be modified to work with Scuttle instead. If you find a tool that won't let you change the API address, ask the creator to add this setting. You never know, they might just do it.


1. Installing Dependencies

1.1. apache2

You will need to install apache2 with:

apt-get install apache2 

No further configuration is required.

1.2. mysql

You need to install mysql too:

apt-get install mysql 

during that set the mysql-roots password. The root of mysql is not the same as the root account of your system.

1.3. scuttle

Then install scuttle:

apt-get install scuttle

During the installation of scuttle you will be asked “Configure database with dbconfig-common?” Answer yes, enter the password of the mysql-root you set above, and then set the password for the scuttle-mysql-database.

2. Configure

To make scuttle available for apache you need to link it to, for example, /var/www:

ln -s /usr/share/scuttle/www /var/www

and can later connect to it by entering your external IP or your domain name into the address bar of a web-browser (or use localhost in the web-browser address bar, if you first want to test this locally). Or link it to:

ln -s /usr/share/scuttle/www /var/www/content

In the latter case you can create a very easy /var/www/index.html, and point it to scuttle (and wordpress or other apps you got stored at /var/www/content). For example:

<!doctype html>
        <meta charset="utf-8">
        <title> Testing mysql/php </title>

            <h1>web applications</h1>
       <h2><a href="/content/scuttle/www">scuttle</a></h2>
       <h2><a href="/content/wordpress">wordpress</a></h2>


Now you can just enter your IP or domain-name and then click on the application you want to use (scuttle in our case)

2.1. Choosing a Locale / Language

3. Creating an account

Just enter your IP or domain name into a web-browser and create an account by clicking on "registrieren" (register). You are able to use it immediately. There does not seem to be a way to decide who can or can't create an account (say via confirmation). This will - sooner or later- lead to a lot of spam accounts. You might want to rename the registration file for php, so no new accounts can't be made at all:

mv /var/www/content/scuttle/www/register.php /var/www/content/scuttle/www/register.php_backup

in case you linked scuttle to /var/www/content (else adapt the command).

That is all which needs to be done. You can import an html-bookmark file now, so you will have got your usual bookmarks at hand: At the login-screen click on "Favorit hinzufügen" (add favorite), scroll down to the page to "Importieren" (import) and then click on "Importiere Favoriten aus einer Datei (Internet Explorer, Mozilla Firefox und Netscape)" (import favorites from a file). Point it to the html file of your bookmarks.








Live Help

Where To Start








To Do








FreedomBox for Communities

FreedomBox Developer Manual

HELP & DISCUSSIONS: Discussion Forum - Mailing List - #freedombox | CONTACT Foundation | JOIN Project

Next call: Sunday, November 24th at 17:00 UTC

Latest news: Announcing Pioneer FreedomBox Kits - 2019-03-26

This page is copyright its contributors and is licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.