{"id":19338808,"url":"https://github.com/fizzygalacticus/starkserver","last_synced_at":"2026-04-27T11:31:06.660Z","repository":{"id":57369522,"uuid":"58685302","full_name":"FizzyGalacticus/StarkServer","owner":"FizzyGalacticus","description":"A very basic NodeJS web server.","archived":false,"fork":false,"pushed_at":"2017-08-18T00:01:01.000Z","size":64,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-07T17:17:29.019Z","etag":null,"topics":["easy-to-use","javascript","node-js","nodejs","server","webserver"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FizzyGalacticus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-05-12T23:58:51.000Z","updated_at":"2022-04-29T16:14:04.000Z","dependencies_parsed_at":"2022-08-26T04:51:56.476Z","dependency_job_id":null,"html_url":"https://github.com/FizzyGalacticus/StarkServer","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FizzyGalacticus%2FStarkServer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FizzyGalacticus%2FStarkServer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FizzyGalacticus%2FStarkServer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FizzyGalacticus%2FStarkServer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FizzyGalacticus","download_url":"https://codeload.github.com/FizzyGalacticus/StarkServer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240441992,"owners_count":19801806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["easy-to-use","javascript","node-js","nodejs","server","webserver"],"created_at":"2024-11-10T03:18:46.533Z","updated_at":"2026-04-27T11:31:06.624Z","avatar_url":"https://github.com/FizzyGalacticus.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StarkServer\n\nStarkServer is a simple, easy to use, and highly configurable web server written for NodeJS. I wanted a way to have a website up in seconds, without all of the extra gunk offered by other webservers.\n\nWith StarkServer, you can:\n* Specify certain filetypes you'd like to serve.\n* Host multiple domains from the same server (virtual hosts).\n* Serve over HTTP and HTTPS.\n* Easily write new Drivers to output to the web in *any* language.\n\n### Tech\n\nStarkServer uses the following technologies to serve your pages:\n\n* [node.js]\n  - fs\n  - path\n  - http\n  - https\n  - recursive-readdir\n  - mime-types\n  - simple-node-logger\n\n### Installation\n\nStarkServer requires [Node.js](https://nodejs.org/) v4.5+ to run.\n\nDownload and extract the [latest release](https://github.com/FizzyGalacticus/StarkServer/archive/master.zip).\n\nInstall the dependencies.\n\n```sh\n$ cd StarkServer\n$ npm install\n```\n\n### Configure\nThere exists a JSON config file that is already setup with the options that are needed, just with generic inputs. You will need to make sure the ports are the ones you wish to bind to, the baseDirectory is set (the directory of your website), and any Drivers are setup if you need them. An example from my config looks like this:\n\n```js\nvar config = {\n    ports: {\n        http: 80,\n        https:443\n    },\n    ssl: {\n        cert:'/home/www/certs/fullchain.pem',\n        key: '/home/www/certs/key.pem'\n    },\n    domains: {\n        localhost:{\n                host            :['localhost', '127.0.0.1', 'hostname'],\n                baseDirectory   :'/home/www/mywebsite',\n                allowedFileTypes:['js','css','html'],\n                index:'index.html',\n                filesToIgnore: ['.gitignore'],\n                directoriesToIgnore:['.git']\n        }\n    },\n    drivers: {\n        name: {\n            DriverFile: 'drivers/php.js',\n            fileTypes:['php']\n        }\n    }\n};\n\nmodule.exports = config;\n```\n\n### Run\nRunning the following should begin the server with your configurations.\n```sh\n$ node run.js\n```\n\nIf this fails, try running as root/administrator. By default, you must be root to bind to port 80 and 443.\n```sh\n$ sudo node run.js\n```\n\n### Development\n\nWant to contribute? That would be awesome!\n\nI use [Waffle.io](https://waffle.io/FizzyGalacticus/StarkServer) to keep track of issues for this project.\n\nLicense\n-------\n\nApache 2.0","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffizzygalacticus%2Fstarkserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffizzygalacticus%2Fstarkserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffizzygalacticus%2Fstarkserver/lists"}