Skip to content
Klutch.sh Docs

Deploying Slash

Introduction

Slash is an open-source, self-hosted bookmark manager and link shortener designed for personal use and team collaboration. It allows you to save, organize, and quickly access your frequently used links using memorable shortcuts, making it an essential productivity tool for developers, teams, and anyone managing many web resources.

Unlike traditional bookmark managers that rely on folders and hierarchies, Slash uses a command-line inspired approach where each link gets a short, memorable name. Type your shortcut, and you’re instantly redirected to your destination. It’s like having a personal URL namespace for all your important links.

Key features of Slash include:

  • Short Links: Create memorable shortcuts like /docs, /github, /calendar
  • Collections: Organize links into logical groups for better management
  • Search: Quickly find any bookmark across your entire collection
  • Browser Extension: Access your shortcuts directly from the browser
  • Team Sharing: Share collections with teammates for collaborative bookmark management
  • Link Analytics: Track how often shortcuts are used
  • Custom Domains: Use your own domain for professional short links
  • API Access: Programmatic link management for automation
  • Tags: Flexible tagging system for cross-collection organization
  • Import/Export: Move bookmarks in and out easily
  • Dark Mode: Eye-friendly dark theme option
  • Mobile Friendly: Responsive design for on-the-go access
  • Open Source: Self-hosted with MIT license

This guide walks through deploying Slash on Klutch.sh using Docker.

Why Deploy Slash on Klutch.sh

Deploying Slash on Klutch.sh provides several advantages:

Simplified Deployment: Klutch.sh handles container builds and deployment automatically.

Data Ownership: Keep your bookmarks and usage data on your own infrastructure.

HTTPS by Default: Automatic SSL certificates for secure bookmark access.

Persistent Storage: Your links survive restarts and redeployments.

Custom Domains: Use a short domain for quick link access.

Team Access: Provide your team with a shared bookmark manager.

Always Available: Access your shortcuts 24/7 from anywhere.

Prerequisites

Before deploying Slash on Klutch.sh, ensure you have:

  • A Klutch.sh account
  • A GitHub account with a repository for your configuration
  • Basic familiarity with Docker
  • (Optional) A short custom domain for quick access

Deploying Slash on Klutch.sh

    Create a GitHub Repository

    Create a new GitHub repository for your Slash deployment configuration.

    Create Your Dockerfile

    Create a Dockerfile:

    FROM yourselfhosted/slash:latest
    

    ENV MODE=prod
    ENV PORT=5231
    ENV DATA=/var/opt/slash
    

    VOLUME /var/opt/slash
    

    EXPOSE 5231
    

    CMD ["./slash", "--mode", "prod", "--port", "5231"]

    Push Your Repository to GitHub

    Commit and push your Dockerfile.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Create a new app and connect your GitHub repository.

    Configure HTTP Settings

    Set the traffic type to HTTP and configure the internal port to 5231.

    Attach Persistent Storage

    Add a persistent volume:

    Mount PathRecommended SizePurpose
    /var/opt/slash1 GBDatabase and application data

    Deploy Your Application

    Click Deploy to start the build process.

    Access Slash

    Once deployment completes, access your Slash instance at your app’s URL.

    Create Your Account

    Sign up for an account on your new instance. The first user becomes the administrator.

    Start Adding Shortcuts

    Begin creating your bookmark shortcuts and organizing them into collections.

Using Slash

After deployment, you can start creating shortcuts:

  1. Create a Shortcut: Click the + button and enter a name and URL
  2. Access a Shortcut: Navigate to https://your-slash.klutch.sh/your-shortcut
  3. Create Collections: Group related shortcuts together
  4. Share with Team: Invite team members to collaborate

Browser Extension

Slash offers browser extensions for quick access:

  1. Install the extension from your browser’s extension store
  2. Configure it with your Slash instance URL
  3. Use the extension to quickly access and create shortcuts

Tips for Effective Use

  • Use short, memorable names for frequently accessed links
  • Create consistent naming conventions for team use
  • Use tags to cross-reference links across collections
  • Set up keyboard shortcuts in the browser extension

Additional Resources

Conclusion

Deploying Slash on Klutch.sh gives you a powerful, self-hosted bookmark manager that streamlines how you access your important links. Whether for personal productivity or team collaboration, Slash’s shortcut-based approach offers a refreshing alternative to traditional bookmark management.

With Klutch.sh handling the infrastructure, you can focus on organizing your digital life and boosting your productivity with instant access to any resource through memorable shortcuts.