| .ci-files | ||
| .github | ||
| docs | ||
| elasticsearch | ||
| resources | ||
| src | ||
| test | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| appveyor.yml | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| gulpfile.js | ||
| gulpfile.ts | ||
| init.js | ||
| jsconfig.json | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
| tslint.json | ||
| update.sh | ||
Misskey
A miniblog-based SNS.
Build
- Install git, Node.js and npm
git clone git://github.com/syuilo/misskey.gitcd misskeynpm installnpm run confignpm run build
Test
npm test
Setup
Dependencies 📦
Please install these softwares.
Optional
- Elasticsearch
- If omit it, Misskey use the MongoDB for search instead. If not, Misskey will can better search.
Domains
Misskey requires two domains called the primary domain and the secondary domain.
- The primary domain is used to provide main service of Misskey.
- The secondary domain is used to avoid vulnerabilities such as XSS.
Ensure that the secondary domain is not a subdomain of the primary domain.
reCAPTCHA
Please visit https://www.google.com/recaptcha/intro/ and generate keys.
Setup with Docker 🐳
Ensure that the working directory is the repository root directory.
To create misskey image:
sudo docker build -t misskey
To run misskey:
sudo docker run --rm -i -t -p $PORT:80 -v $(pwd):/root/misskey -v $DBPATH:/data/db misskey
where $PORT is the port used to access Misskey Web from host browser and $DBPATH is the path of MongoDB database on the host for data persistence.
ex: sudo docker run --rm -i -t -p 80:80 -v $(pwd):/root/misskey -v /data/db:/data/db misskey
Note that $(pwd) is the working directory.
Launch
sudo npm start
Contribute
Do you have feature request or problem with Misskey? Please create issue to report it.
Currently Misskey is missing documents so writing documents would be appreciated. Pull requests are always welcome.
We love contributions from anybody.
TODO
- More tests!
- More docs!
- More refactorings!