sus

sus URL shortener

susmng usage (managing shortlinks)

• creating a new shortlink at https://pls.cx/shortlink

    susmng [-s pls.cx] create -l shortlink -r https://example.com
  

• creating a new shortlink at https://pls.cx/shortlink which redirects to https://example.com/a the first n times, https://example.com/b any other times

    susmng [-s pls.cx] create -l shortlink -r https://example.com/a \
            -c hits,gt,<n> -a https://example.com/b
  

• creating a new shortlink at https://pls.cx/shortlink which redirects to https://example.com/before before unix timestamp n (seconds), https://example.com/after after that

    susmng [-s pls.cx] create -l shortlink -r https://example.com/before \
            -c timestamp,gt,<n> -a https://example.com/after
  

• deleting the shortlink https://pls.cx/shortlink

    susmng [-s pls.cx] delete -l shortlink
  

• listing all shortlinks on the server pls.cx

    susmng [-s pls.cx] list
  

susmng will assume the first server in the secrets section of the configuration file if the -s flag is not provided.

installation

running the server

1. generate the secret used to create and delete shortlinks

    echo SECRET=`pwgen -s 64 1` >> .env
   

2. run the services

    docker-compose up -d --build
   

server environment variables

• SECRET---the secret used for signature verification
• LISTEN_ADDRESS---the address the server is listening on (default is 0.0.0.0:80)
• INDEX_GET_REDIRECT---the URL the user should be redirected to if they try to access / on the server (default is http://alv.cx)

setting up susmng

1. install susmng

    make install-susmng
   

2. create configuration files

    susmng init
   

3. edit configuration files (~/.config/susmng/config.json) to add your secrets