Skip to content

marcellozaniboni/httpiccolo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

httpiccolo

a small http file server

About httpiccolo

This project was initially born for personal needs: I just needed a minimal web file server, to be installed on my own server and then I started to code it using Go.

Features

  • Very easy to install: it's just a static binary with no dependencies.
  • Very easy to configure: on first start the user is asked only four questions and the rest of the configuration is done using the administration web interface.
  • All the configuration is saved in three json files in a directory reserved for this purpose. The configuration can be modified from the administration web interface (but the files can also be easily modified manually, if needed). You can reset the configuration pointing to another directory or by simply deleting it.

Status

At the moment the software is still in beta, but it works, it's quite stable and hopefully without security bugs. So and I started using it for personal purposes on my servers.

The administration web interface can certainly be improved before the version 1.0 will be released. I also have already planned to add new features after 1.0.

First run

  1. Download the executable binary for your OS.
  2. Just put the executable file in your filesystem and run it.
  3. You will be asked for questions and the the configuration directory will be created.
  4. By default a configuration subdirectory will be created in the same directory as the executable file. If you want to use another path, use the command line argument -c to specify it.
  5. You can run "httpiccolo -h" to have a list of available command line arguments.

Download binaries

Download here precompiled binaries for Windows x86 64-bit, Linux x86 64-bit, Linux ARM 64-bit, Linux ARM 32-bit

How to build

Install Go (minimum version 1.19)

Quick compile and run:

  • for Windows: run.bat
  • for Linux: run.sh

To build an optimized release executable, install UPX and

  • for Windows: edit build-release.bat and fix UPX path, then run build-release.bat
  • for Linux: run build-release.sh

About

a small http file server

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages