FoundKey microblogging server.
Find a file
2017-02-27 17:39:23 +09:00
.ci-files ✌️ 2017-01-17 08:42:24 +09:00
.github Update ISSUE_TEMPLATE 2016-12-31 13:43:55 +09:00
docker Add graphicsmagick 2016-12-31 13:31:56 +09:00
docs Clean up 2017-02-22 10:49:11 +09:00
elasticsearch Initial commit 🍀 2016-12-29 07:49:51 +09:00
resources Add screen shot 2016-12-29 20:43:38 +09:00
src Fix typo: protcols -> protocols 2017-02-27 17:39:23 +09:00
test Fix bug 2017-02-22 19:39:34 +09:00
tools Extract user's profile 2017-02-22 12:43:15 +09:00
.editorconfig Remove comments 2017-01-03 04:17:04 +09:00
.gitattributes Initial commit 🍀 2016-12-29 07:49:51 +09:00
.gitignore Add /uploads directory to .gitignore 2017-02-12 01:39:58 +09:00
.travis.yml Update .travis.yml 2017-02-23 06:19:49 +09:00
CHANGELOG.md Fix typo: deperecated -> deprecated 2017-02-27 17:39:22 +09:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-02-14 05:33:02 +09:00
gulpfile.ts Clean up 2017-02-27 02:51:38 +09:00
jsconfig.json Remove useless link 2016-12-31 03:42:55 +09:00
LICENSE LICENSE: Update year to 2017 2016-12-31 22:09:31 +09:00
package.json Clean up 2017-02-27 02:51:38 +09:00
README.md Update README.md 2017-02-27 17:39:22 +09:00
swagger.js [Swagger]Add /meta 2017-01-06 23:41:16 +09:00
tsconfig.json Separate tsconfig.json so that ts-node can work with gulpfile.ts 2017-02-23 00:54:08 +09:00
tslint.json Update tslint.json 2016-12-29 10:01:59 +09:00
webpack.config.ts Clean up 2017-02-27 02:51:38 +09:00

Misskey

Welcome!

Misskey is a completely open source, ultimately sophisticated new type of mini-blog based SNS.

ss

Key features

  • Automatically updated timeline
  • Private chatting (messaging)
  • Free 1GB storage
  • Mobile device support (smartphone, tablet, etc)
  • Third-party application support
  • Twitter integration

and more! You can touch with your own eyes at https://misskey.xyz/.

Setup

Dependencies 📦

Please install these softwares.

Optional

  • Elasticsearch - used to provide searching feature instead of MongoDB

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.

Subdomains

Note that Misskey uses following subdomains:

  • api.{primary domain}
  • auth.{primary domain}
  • about.{primary domain}
  • dev.{primary domain}
  • file.{secondary domain}

reCAPTCHA tokens

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 ./docker

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

If you want to run misskey in production mode, add --env NODE_ENV=production like this:

sudo docker run --rm -i -t -p 80:80 -v $(pwd):/root/misskey -v /data/db:/data/db --env NODE_ENV=production misskey

Note that $(pwd) is the working directory.

Building

Run npm run build after npm install. GLHF!

Launch

sudo npm start

Testing

Run npm test after building

Debugging 🐛

Show a debug messages

Misskey uses debug and namespace is misskey:*.

Contribute

Do you have feature request or problem with Misskey? Please create issue to report it if it is about the Misskey implementation itself.

Currently Misskey is missing documents so writing documents would be appreciated. Pull requests are always welcome.

We love contributions from anybody.

Contribution guide

TODO

  • More tests!
  • More docs!
  • More cleaning up code!

Collaborators

syuilo Morisawa Aya
syuilo Aya Morisawa

Misskey is an open-source software licensed under The MIT License.

🍮