Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

seriousm4x/UpSnap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

UpSnap

A simple wake on lan web app written with SvelteKit, Go and PocketBase.

โœจ Features

  • ๐Ÿš€ One-Click Device Wake-Up Dashboard
  • โฐ Timed Events via Cron for Automation
  • ๐Ÿ”Œ Ping Any Port You Choose
  • ๐Ÿ” Discover Devices with Network Scanning (nmap required)
  • ๐Ÿ‘ค Secured User Management
  • ๐ŸŒ i18n support for these languages
  • ๐ŸŽจ 29 Themes
  • ๐Ÿณ Docker images for amd64, arm64, arm/v7, arm/v6
  • ๐Ÿ  Self-Hostable

๐Ÿ“ธ Screenshots

Dark Light

๐Ÿง Install from the AUR

yay -Sy upsnap-bin

๐Ÿš€ Run the binary

Just download the latest binary from the release page and run it.

Root:

sudo ./upsnap serve --http=0.0.0.0:8090

Non-root:

sudo setcap cap_net_raw=+ep ./upsnap # only once after downloading
./upsnap serve --http=0.0.0.0:8090

For more options check ./upsnap --help or visit PocketBase documentation.

If you want to use network discovery, make sure to have nmap installed and run UpSnap as root/admin.

๐Ÿณ Run in docker

You can use the docker-compose example. See the comments in the file for customization.

Non-root docker user:

Create the mount point first:

mkdir data

Then add user: 1000:1000 to the docker-compose file (or whatever your $UID:$GID is).

Change port

If you want to change the port from 8090 to something else, change the following (5000 in this case):

entrypoint: /bin/sh -c "./upsnap serve --http 0.0.0.0:5000"
healthcheck:
  test: curl -fs "http://localhost:5000/api/health" || exit 1

Install additional packages for shutdown cmd

entrypoint: /bin/sh -c "apk update && apk add --no-cache <YOUR_PACKAGE> && rm -rf /var/cache/apk/* && ./upsnap serve --http 0.0.0.0:8090"

You can search for your needed package here.

Reverse Proxy

Caddy example

upsnap.example.com {
    reverse_proxy localhost:8090
}

๐Ÿ”’ User permissions

UpSnap offers unique access for each user, per device. While admins have all permissions, they can assign specific rights to users such as displaying/hiding a device, accessing device editing, deleting and powering devices on/off. See the last screenshot in the ๐Ÿ“ธ Screenshots section.

๐ŸŒ Exposing to the open web

Although UpSnap has user authorisation, it is not recommended to expose it to the open web and make it accessible by everyone!

Reason: The shutdown device command is basically a command piped to #sh (root if you run docker). If anyone gains unauthorized access and can abuse this api route in any way, the attacker has access to a (root) shell on your local network.

Recommended: If you need access from outside your network, please use a vpn. Wireguard or OpenVPN is your way to go.

๐ŸŒ Help translating

UpSnap is available in the following languages so far:

  • ๐Ÿ‡บ๐Ÿ‡ธ English (en-US)
  • ๐Ÿ‡ฉ๐Ÿ‡ช German (de-DE)
  • ๐Ÿ‡ช๐Ÿ‡ธ Spanish (es-ES)
  • ๐Ÿ‡ซ๐Ÿ‡ท French (fr-FR)
  • ๐Ÿ‡ฎ๐Ÿ‡น Italian (it-IT)
  • ๐Ÿ‡ณ๐Ÿ‡ฑ Dutch (nl-NL)
  • ๐Ÿ‡ต๐Ÿ‡น Portuguese (pt-PT)
  • ๐Ÿ‡จ๐Ÿ‡ณ Chinese (zh-CN)
  • ๐Ÿ‡น๐Ÿ‡ผ Chinese (Taiwan) (zh-TW)

If you want to contribute and help translating, check the wiki: How to add languages

๐Ÿ”ง Help developing

Fork this branch and clone it.

  1. Start backend
cd backend
go mod tidy
go run main.go serve
  1. Start frontend
cd frontend
pnpm i
pnpm run dev

Open up http://localhost:5173/, create an admin user and add some devices.

๐ŸŒŸ Star History

Star History Chart