mirror of
https://github.com/javi11/altmount.git
synced 2025-12-07 00:02:33 -08:00
usenet virtual fs
| .github | ||
| cmd/altmount | ||
| docker | ||
| docs | ||
| frontend | ||
| internal | ||
| pkg/rclonecli | ||
| .dockerignore | ||
| .DS_Store | ||
| .gitignore | ||
| .golangci.yml | ||
| altmount | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| config.sample.yaml | ||
| docker-compose-dev.yml | ||
| docker-compose.volume-plugin.example | ||
| docker-compose.yml | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
AltMount
A WebDAV server backed by NZB/Usenet that provides seamless access to Usenet content through standard WebDAV protocols.
📖 Documentation
Complete setup guides, configuration options, API reference, and troubleshooting information.
Quick Start
Docker (Recommended)
services:
altmount:
extra_hosts:
- "host.docker.internal:host-gateway" # Optional if you rclone is outside the container
image: ghcr.io/javi11/altmount:latest
container_name: altmount
environment:
- PUID=1000
- PGID=1000
- PORT=8080
- COOKIE_DOMAIN=localhost # Must match the domain/IP where web interface is accessed
volumes:
- ./config:/config
- /mnt:/mnt:rshared
- /metadata:/metadata # This is optional you can still use /mnt
ports:
- "8080:8080"
restart: unless-stopped
devices:
- /dev/fuse:/dev/fuse:rwm
cap_add:
- SYS_ADMIN
security_opt:
- apparmor:unconfined
CLI Installation
go install github.com/javi11/altmount@latest
altmount serve --config config.yaml
Links
- 📚 Documentation
- 🐛 Issues
- 💬 Discussions
Contributing
See the Development Guide. Development/setup for information on setting up a development environment and contributing to the project.
License
This project is licensed under the terms specified in the LICENSE file.
