Differences between revisions 10 and 11
Revision 10 as of 2015-01-16 11:57:35
Size: 4602
Comment: Add category FreedomBox
Revision 11 as of 2015-02-13 04:40:50
Size: 4638
Comment: Include FreedomBox portal in footer
Deletions are marked like this. Additions are marked like this.
Line 100: Line 100:


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).

Homepage: http://sourceforge.net/projects/scuttle

Description: Web-based social bookmarking system

  • Allows multiple users to store, share and tag their favourite links online.
    • Scuttle supports most of the del.icio.us 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.


Installing Dependencies


You will need to install apache2 with:

apt-get install apache2 

No further configuration is required.


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.


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.


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)

Choosing a Locale / Language

  • I could not find a way to set the language to a different one than German. The layout is so easy that you should be able to navigate in the German version too.
  • A kludge exists to change the language: delete the unwanted locales (or simply remove them from the /var/www/scuttle/www/locales folder). Instead leave only the locale that you want behind (e.g. British English) /en_GB/ and ./messages.po in this directory /var/www/scuttle/www/locales/

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.



Work Space





Live Help

Where To Start








To Do





Use cases





HELP & DISCUSSIONS: Mailing List - #freedombox irc.debian.org | CONTACT Foundation | JOIN Project

Next call: Saturday, July 14th at 14:00 UTC

Latest news: Stable FreedomBox images - 2017-08-05

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