GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - beromir/Servas: A self-hosted bookmark management tool.

BranchesTags
Open more actions menu

Latest commit

 

History

472 Commits
472 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
app
app
 
 
bootstrap
bootstrap
 
 
config
config
 
 
database
database
 
 
docker
docker
 
 
docs/images
docs/images
 
 
lang
lang
 
 
public
public
 
 
resources
resources
 
 
routes
routes
 
 
storage
storage
 
 
tests
tests
 
 
.dockerignore
.dockerignore
 
 
.editorconfig
.editorconfig
 
 
.env.example
.env.example
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
.npmrc
.npmrc
 
 
.styleci.yml
.styleci.yml
 
 
Caddyfile
Caddyfile
 
 
Dockerfile
Dockerfile
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
artisan
artisan
 
 
composer.json
composer.json
 
 
composer.lock
composer.lock
 
 
docker-entrypoint.sh
docker-entrypoint.sh
 
 
jsconfig.json
jsconfig.json
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
phpunit.xml
phpunit.xml
 
 
ray.php
ray.php
 
 
vite.config.js
vite.config.js
 
 

Repository files navigation

Servas

A self-hosted bookmark management tool.
Servas is based on Laravel and Inertia.js and uses Tailwind CSS and Svelte for the frontend.

Features

  • Tags: Organize your bookmarks with tags.
  • Groups: Group your bookmarks. Groups can be nested.
  • Smart Groups: Group your bookmarks based on their belonging tags.
  • Firefox and Chrome browser extension: Add sites to Servas right from your browser.
  • Multiple users: You can create multiple user accounts.
  • Responsive design: Servas looks good on all your devices.
  • Import/Export: Support for JSON and HTML bookmarks.
  • Dark/light theme.
  • Two Factor Authentication available.

How to install

Docker

Servas is available as an official Docker image.

The preferred way to use Servas is with SQLite. This variant does not need an additional database container.
You can find the example files here:

  • compose.yaml
  • .env

The Docker image also supports MySQL and MariaDB.
You can find the example files here:

  • compose.yaml
  • .env

Initial steps:

  1. Create .env file in the directory where the compose.yaml is located.
  2. Copy the content of the example env file into the .env file.
  3. Change the APP_URL.
  4. Use a strong password for the DB_PASSWORD setting (only required if Servas is used with MariaDB).
  5. Start the containers with docker compose up -d.
  6. Generate the application key:
docker exec -it servas php artisan key:generate --force
  1. Restart the containers with docker compose restart.
  2. Open your browser and create a user account at https://your-servas-instance/register.

Manual

Requirements:

  • PHP 8.4
  • MariaDB, MySQL or SQLite
  • Git
  • Node.js
  • Composer
  1. Clone the repo.
  2. Install the Composer packages.
composer install --optimize-autoloader --no-dev
  1. Install the npm packages.
npm install
  1. Compile the assets.
npm run build
  1. Create .env file from the .env.example file.
  2. Change the settings in the .env file according to your needs.
  3. If you are using SQLite, you must remove the MySQL section in the .env file and uncomment the SQLite section.
  4. Run the database migrations.
php artisan migrate
  1. Generate the application key.
php artisan key:generate

Configuration

You can change some application settings in the .env file.

Description .env key Options
Enable/Disable user registration SERVAS_ENABLE_REGISTRATION true/false
Show/Hide version number in profile dropdown SERVAS_SHOW_APP_VERSION true/false

After making changes to the .env file, you must restart the application container.

User Guide

Register a new user at https://your-servas-instance/register.

Browser Extensions

Firefox and Chrome: https://github.com/beromir/servas-extension

Screenshots

Visit the website.

About

A self-hosted bookmark management tool.

servas.app

Topics

bookmark-managerinertiajslaravelphpself-hostedselfhostedsveltejstailwindcsswebapp

Resources

Readme
GPL-3.0 license
Activity

Stars

840 stars

Watchers

4 watching

Forks

38 forks
Report repository

Releases

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.