diff --git a/Makefile b/Makefile
index c8eb32a..4e7da56 100644
--- a/Makefile
+++ b/Makefile
@@ -21,9 +21,9 @@
 GIT_HOST = git.openstack.org
 SHELL := /bin/bash
 
-STACKUBE_VERSION = 0.1
-STACKUBE_PROXY_VERSION = 0.1
-KUBESTACK_VERSION = 0.1
+STACKUBE_VERSION = 1.0beta
+STACKUBE_PROXY_VERSION = 1.0beta
+KUBESTACK_VERSION = 1.0beta
 
 PWD := $(shell pwd)
 BASE_DIR := $(shell basename $(PWD))
diff --git a/cmd/kubestack/kubestack.go b/cmd/kubestack/kubestack.go
index 5172e4f..c8a9d3e 100644
--- a/cmd/kubestack/kubestack.go
+++ b/cmd/kubestack/kubestack.go
@@ -45,7 +45,7 @@ import (
 
 var (
 	// VERSION is filled out during the build process (using git describe output)
-	VERSION = "0.1"
+	VERSION = "1.0beta"
 
 	netnsBasePath = "/var/run/netns"
 )
diff --git a/cmd/stackube-controller/stackube-controller.go b/cmd/stackube-controller/stackube-controller.go
index 9216c2b..1cf6e53 100644
--- a/cmd/stackube-controller/stackube-controller.go
+++ b/cmd/stackube-controller/stackube-controller.go
@@ -46,7 +46,7 @@ var (
 	userCIDR    = pflag.String("user-cidr", "10.244.0.0/16", "user Pod network CIDR")
 	userGateway = pflag.String("user-gateway", "10.244.0.1", "user Pod network gateway")
 	version     = pflag.Bool("version", false, "Display version")
-	VERSION     = "0.1"
+	VERSION     = "1.0beta"
 )
 
 func startControllers(kubeClient *kubernetes.Clientset,
diff --git a/cmd/stackube-proxy/stackube-proxy.go b/cmd/stackube-proxy/stackube-proxy.go
index 95b7843..cff58d8 100644
--- a/cmd/stackube-proxy/stackube-proxy.go
+++ b/cmd/stackube-proxy/stackube-proxy.go
@@ -36,7 +36,7 @@ var (
 	cloudconfig = pflag.String("cloudconfig", "/etc/stackube.conf",
 		"path to stackube config file")
 	version = pflag.Bool("version", false, "Display version")
-	VERSION = "0.1"
+	VERSION = "1.0beta"
 )
 
 func verifyClientSetting() error {
diff --git a/deployment/stackube-proxy.yaml b/deployment/stackube-proxy.yaml
index 4b22c13..c3695cd 100644
--- a/deployment/stackube-proxy.yaml
+++ b/deployment/stackube-proxy.yaml
@@ -55,7 +55,7 @@ spec:
       containers:
         - name: stackube-proxy
           resources: {}
-          image: stackube/stackube-proxy:v0.1
+          image: stackube/stackube-proxy:v1.0beta
           securityContext:
             privileged: true
           command: ["/start.sh"]
diff --git a/deployment/stackube.yaml b/deployment/stackube.yaml
index 8b1c4d2..b534565 100644
--- a/deployment/stackube.yaml
+++ b/deployment/stackube.yaml
@@ -41,7 +41,7 @@ spec:
         # This container installs the kubestack CNI binaries
         # and CNI network config file on each node.
         - name: install-cni
-          image: stackube/kubestack:v0.1
+          image: stackube/kubestack:v1.0beta
           command: ["/install-cni.sh"]
           env:
             # The endpoint of openstack authentication.
@@ -155,7 +155,7 @@ spec:
       serviceAccountName: stackube-controller
       containers:
         - name: stackube-controller
-          image: stackube/stackube-controller:v0.1
+          image: stackube/stackube-controller:v1.0beta
           command: ["/start.sh"]
           env:
             # The endpoint of openstack authentication.
diff --git a/doc/source/conf.py b/doc/source/conf.py
index bd7754c..11d0b87 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -87,7 +87,7 @@ copyright = u'2017-present, OpenStack Foundation.'
 # Version info
 # The short X.Y version.
 # TODO(harry) No stackube version info yet
-version = "0.1"
+version = "1.0beta"
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/doc/source/developer.rst b/doc/source/developer.rst
index 0c95cf1..d58dabd 100644
--- a/doc/source/developer.rst
+++ b/doc/source/developer.rst
@@ -52,9 +52,9 @@ Three docker images will be built:
 
 ::
 
-  stackube/stackube-proxy:v0.1
-  stackube/stackube-controller:v0.1
-  stackube/kubestack:v0.1
+  stackube/stackube-proxy:v1.0beta
+  stackube/stackube-controller:v1.0beta
+  stackube/kubestack:v1.0beta
 
 ===========================
 (Optional) Configure Stackube
diff --git a/doc/source/index.rst b/doc/source/index.rst
index b01bdaa..38281e1 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -45,3 +45,11 @@ User Guide
    :maxdepth: 2
 
    user_guide
+
+Release Note
+================
+
+.. toctree::
+   :maxdepth: 2
+
+   release_notes/1_0
diff --git a/doc/source/release_notes/1_0.rst b/doc/source/release_notes/1_0.rst
new file mode 100644
index 0000000..e8f72e3
--- /dev/null
+++ b/doc/source/release_notes/1_0.rst
@@ -0,0 +1,82 @@
+Stackube Release Note
+=====================================
+
+=========
+1.0 Beta
+=========
+
+=========
+Prelude
+=========
+
+This is the 1.0 Beta release of Stackube: a secure, multi-tenant and 
+Kubernetes centric OpenStack distribution.
+
+=========
+New Features
+=========
+
+1. Implemented a auth controller watches on tenant/networks/namespaces 
+change and setups RBAC roles for tenant. This is how we match Kubernetes 
+authorization control with OpenStack tenant by: tenant namespace 1:1 
+mapping. Controller is implemented by using CRD of Kubernetes.
+
+2. Implemented a network controller watches on networks/namespaces change 
+and operates OpenStack network based on network namespace 1:1 mapping. This 
+is how to define Kubernetes multi-tenant network by using Neutron. 
+Controller is implemented by using CRD of Kubernetes.
+
+3. Implemented a CNI plug-in which name is kubestack. This is a CNI plug-in 
+for Neutron and work with the network controller model mentioned above. When 
+network of Neutron is ready, kubestack will be responsible to configure Pods 
+to use this network by following standard CNI workflow.
+
+4. Implemented stackube-proxy to replace default kube-proxy in Kubernetes so 
+that proxy will be aware of multi-tenant network.
+
+5. Implemented stackube DNS add-on to replace default kube-dns in Kubernetes 
+so that DNS server will be aware of multi-tenant network.
+
+6. Integrated cinder-flexvolume of kubernetes/frakti project so that hypervisor based container runtime (runV) in Stackube can mount Cinder volume (RBD) directly to VM-based Pod. This will bring better performance to 
+user.
+
+7. Improved stackube-proxy so that Neutron LBaaS based service can be used 
+in Stackube when LoadBalancer type service is created in Kubernetes.
+
+8. Created Docker images for all add-on and plug-in above so they can be 
+deployed in Stackube by one command.
+
+9. Add deployment documentation for Stackube which will install Kubernetes + 
+mixed container runtime + CNI + volume plugin + standalone OpenStack components.
+
+
+=========
+Known Issues
+=========
+
+None
+
+=========
+Upgrade Notes
+=========
+
+None
+
+=========
+Deprecation Notes
+=========
+
+None
+
+=========
+Bug Fixes
+=========
+
+1. Fixed CNI network namespace is not cleaned properly
+
+=========
+Other Notes
+=========
+
+This is the 1.0 Beta release of Stackube, reporting bugs in https://
+bugs.launchpad.net/stackube during you exploration is highly appreciated!