FoundKey microblogging server.
Find a file
こぴなたみぽ 5fbd55f714 Update README.md
2017-05-17 10:37:10 +09:00
.github Update ISSUE_TEMPLATE 2016-12-31 13:43:55 +09:00
.travis Update .travis.yml 2017-03-01 19:27:25 +09:00
assets Add logo 🎨 2017-03-30 08:57:42 +09:00
docker Add graphicsmagick 2016-12-31 13:31:56 +09:00
docs #309 and some cleanups 2017-03-22 16:19:32 +09:00
elasticsearch Initial commit 🍀 2016-12-29 07:49:51 +09:00
locales Remove the Live service 2017-04-15 22:05:23 +09:00
src Revert "Compress an assets" 2017-05-17 00:36:04 +09:00
test #298 2017-03-20 04:24:19 +09:00
tools #298 2017-03-20 04:24:19 +09:00
webpack Update i18n.ts 2017-05-17 06:22:54 +09:00
.editorconfig Update .editorconfig 2017-03-31 01:31:24 +09:00
.gitattributes Update .gitattributes 2017-03-14 21:30:24 +09:00
.gitignore Add /uploads directory to .gitignore 2017-02-12 01:39:58 +09:00
.travis.yml 7.7.3 2017-03-18 00:02:53 +09:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-03-31 03:14:02 +09:00
gulpfile.ts Refactoring 2017-05-17 00:00:56 +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 fix(package): update serve-favicon to version 2.4.3 2017-05-16 21:55:47 +00:00
README.md Update README.md 2017-05-17 10:37:10 +09:00
swagger.js [Swagger]Add /meta 2017-01-06 23:41:16 +09:00
tsconfig.json Clean up 2017-03-04 19:21:04 +09:00
tslint.json Migrate to tslint 5.1.0 2017-04-14 20:45:37 +09:00

Misskey

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

ss

Key features

  • Automatically updated timeline
  • Private messages
  • Free 1GB storage
  • Mobile device support (smartphone, tablet, etc)
  • Web API for third-party applications
  • 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.

Install

Using built code

We have official release of Misskey. The built code is automatically pushed to https://github.com/syuilo/misskey/tree/release after the CI test succeeds.

  1. git clone -b release git://github.com/syuilo/misskey.git
  2. cd misskey
  3. npm install

Update

  1. git fetch
  2. git reset --hard origin/release
  3. npm install

Using source code

If you want to build Misskey manually, you can do it via build command after download the source code of Misskey and install dependencies:

  1. git clone -b master git://github.com/syuilo/misskey.git
  2. cd misskey
  3. npm install
  4. npm run build

Update

  1. git pull origin master
  2. npm install
  3. npm run build

Launch

Just sudo npm start. GLHF!

Testing

Run npm test after building

Debugging 🐛

Show debug messages

Misskey uses debug and the namespace is misskey:*.

Contribution

Please see Contribution guide.

Collaborators

syuilo Morisawa Aya otofune
syuilo Aya Morisawa Otoha Funabashi

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